
ykhwong's CVS build

======
NOTE
======

  Before reading this document, please read DOSBOX_EN.TXT first.


==============
 Special keys
==============

  One or more experimental patches provide the following additional special keys.

   Core-related feature (gulikoza)
     Ctrl - 1       Normal core
     Ctrl - 2       Full core
     Ctrl - 3       Dynamic core
     Ctrl - 4       Simple core
     Ctrl - =       Maximize CPU cycle

   Daum Cafe build feature (ykhwong)
     Ctrl - Alt - F9    Hide/show menu bar
     Ctrl - Alt - F12   Unlock/Lock speed

   Image-related feature (prompt)
     Ctrl - F3      Cycle disk
     Alt - F3       Cycle drive

  For more information about special keys, read DOSBOX_EN.TXT.


==============
 Parameters
==============

  One or more experimental patches provide the following additional parameters.

   Usage
   dosbox.exe [-nomenu] [-nogui] [-showcycles] [-svgachipset chipsetname]

   -nomenu
     Hide menu bar at startup. To show it, press Ctrl-Alt-F9.

   -nogui
     Disables Graphic User Interface. It might fix some bugs related to GUI.

   -showcycles
     Show detailed information including the current cycles and FPS at startup.

   -svgachipset chipsetname
     Enables an accelerated graphic chipset. (e.g, -svgachipset et4000)
   

   Creating a shortcut for dosbox.exe is recommended.
   For more information about DOSBox parameters, read DOSBOX_EN.TXT.


===========
 DemoVGA
===========

  Provided by h-a-l-9000.
  If you get any distorted image while playing a game, try to set machine=demovga.


==================
 DOS commands
==================

  The follwoing additional commands are provided from a patch "More parameters support in internal commands."

  1. TIME
     Displays time.

  2. DATE [day] [month] [year]
     Displays/Changes date.
     Note that changing date is not that complete and the time information will be used only on the dos level.

  3. MOUSE [/U]
     Enables/disables DOSBox mouse driver. To uninstall it, type "mouse /u"
     This command is still rudimental. It is useful when some applications do not work with the mouse driver.

  4. MORE [drive:][path]filename
     Displays output of a textfile one screen at a time.

  5. PROMPT [text]
     Changes the command prompt. It supports most special codes including escape code.
     For more information, type "prompt /?"

  6. LABEL [volume]
     Creates/Changes the volume label of a disk.
     You can even change the label of the virtual drives except the internal drive.

  7. VOL [drive:]
     Displays the disk volume label and serial number, if they exist.  

  8. ADDKEY [key]
     It generates artifical keypresses. It was created by Moe.

  For more information about DOS commands, type "HELP" on prompt.


=======
 Menu
=======

   A nice menu bar for GUI is provided with my build.

   1. Main
   2. Cpu
   3. Display
   4. Sound
   5. DOS
   6. Capture
   7. Drives

  With Moe's User Interface patch, you can also change the DOSBox configuration.


========
 Mount
========

   1. Zip Mount
    This feature is created by Moe, and it was helped by physfs library.

    For example, if there is game.zip in d:\ and you would like to mount D drive, type
       mount d d:\game.zip:\

    Also, if there is game.7z in c:\ and you would like to mount E drive, type
       mount e c:\game.7z:\

    For details, go to http://sourceforge.net/tracker/index.php?func=detail&aid=1240030&group_id=52551&atid=467234

   2. CD image disk cycling
    Usage: imgmount d disc1.img disc2.img disc... -t iso
    Cycle disk : Ctrl-F3
    Cycle drive : Alt-F3 (only needed with multiple drives: Selects drive whose disks are to be cycled)


==============
 COPY CON
==============

 On dos prompt, type "copy con [filename]"
 To move to the next row, press Ctrl-Enter. To exit from the buffer, just press Enter.
 Note that Ctrl-Z / F7 or Ctrl-C won't work!


=======
 Glide
=======

  Glide patch is maintained by Gulikoza, and it uses OpenGlide.
  Set glide=true in your dosbox configuration file to play Glide games.
  Note that the Glide games may not work in Windows Vista+ATI VGA.

   How to enjoy glide games in FULLSCREEN
    1. Choose one of the following ways first:
       1) Open DOSBox.Conf, set glide=true, and save. -> Run DOSBox and quit.
       2) Run DOSBox -> Go to 'DOS' - 'Glide' menu to enable glide emulation. -> Quit
    2. You will find a file named OpenGlid.ini. Open it with notepad, set InitFullscreen=1, and save.
    3. Turn off GUI by adding a parameter "-nogui" to dosbox.exe
    4. Run DOSBox, and then enjoy Glide games.


==============
 New outputs
==============

  There are a couple of additional outputs provided: Direct3D and OpenglHQ

   Direct3D: Provided by Gulikoza, For Windows, Interesting pixel shaders
   OpenglHQ: Provided by Moe, Uses an independent video driver, Incompatible with menu

   For more information about Direct3D, read Direct3D_EN.TXT.
   For more information about OpenglHQ, read Opengl-HQ_EN.TXT.


================
 Windows Vista
================

   dosbox_admin.exe gives you an administrative right to dosbox.exe.
   For security, it is not recommended. However, if you do not want to encounter write-protection problems, try it.
   Someone reported that there was a sound problem in Windows 2003 but dosbox_admin.exe fixes it.


==============
 Addons/Util
==============

 You can download the following four programs from my page(http://ykhwong.x-y.net) or other sites.

 1. Optimization mode (English ver.)
     If the size of your system memory is too low, try optimization mode.
     This mode temporarily kills a process 'explorer.exe' to allocate more memory for DOSBox.

 2. ZMBV AVI Codec
     You can install this codec by installing the latest official version of dosbox.
     To play movies captured by dosbox, you need to download the codec.

 3. NETBIOS
     For DOSBox, type 'ipx true' on prompt or set ipx=true in dosbox.conf before running netbios.

 4. VESA drivers for specific svga chipsets
     If your game complains about vesa drivers, install S3/Tseng/Paradise vesa drivers.
     You may use UNIVBE instead.
